Opportunity token messages
Description
AI follow-up messages for tokens flagged as having upside potential.
Use cases
- Live narrative on opportunity names
- Major-player actions (enter, add, trim, exit, …)
Tips
- Pair with Opportunity token list — use this for message history per listed token
Update: Every 5 minutes
Endpoint
- Method:
POST - Path:
/open/v1/ai/getChanceCoinMessageList
Credits
- Cost:
3
Prerequisites
vsTokenId
Request body (JSON)
| Field | Type | Required | Description |
|---|---|---|---|
| vsTokenId | long | Yes | Token id |
Response — data[]
| Field | Type | Serialized | Description |
|---|---|---|---|
| updateTime | long | long | Updated at (ms) |
| vsTokenId | long | string | VS token id |
| symbol | string | string | Ticker |
| name | string | string | Name |
| chanceMessageType | integer | integer | Message type |
| scoring | number | number | Score |
| grade | integer | integer | Grade |
| price | number | string | Price |
| percentChange24h | number | number | 24h change |
| gains | number | number | Upside move |
| decline | number | number | Drawdown |
Semantics
| Field | Meaning | Tip |
|---|---|---|
| chanceMessageType | Taxonomy | Maps to ChanceMessageType enum |
| scoring | Confidence | Higher → stronger signal |
| grade | Bucket | Severity / tier |
Example
json
{
"vsTokenId": 23335
}cURL (Linux/macOS)
bash
curl --location --request POST 'http://${host}/api/open/v1/ai/getChanceCoinMessageList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
"vsTokenId": 23335
}'cURL (Windows CMD)
cmd
curl --location --request POST "http://${host}/api/open/v1/ai/getChanceCoinMessageList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{ \"vsTokenId\": 23335}"Sample success
json
{
"code": 200,
"message": "success",
"data": [
{
"updateTime": 1773071700000,
"vsTokenId": "23335",
"symbol": "THE",
"name": "THENA",
"chanceMessageType": 30,
"scoring": 0.0,
"grade": 2,
"price": "0.2742",
"percentChange24h": 6.18293206,
"gains": 5.0743990000000005,
"decline": 0.363108
}
],
"requestId": "xxx-xxx-xxx"
}